Adopt python-copier-template 5.5.0 - #216

What and why

Adopts python-copier-template 5.5.0, generated with copier copy so .copier-answers.yml is present and future copier update runs work.

• The package moves to the template's src/ layout (git mv softioc src/softioc, including the iocStats submodule), so file history is kept and no source file changes.
• uv.lock replaces Pipfile/Pipfile.lock; metadata moves from setup.cfg to pyproject.toml [project]. setup.py still builds the setuptools_dso extension and sets install_requires (declared dynamic), so the epicscorelibs ABI pin from abi_requires() is kept.
• epicscorelibs: released wheels and sdists (cibuildwheel, pip) build against the newest epicscorelibs allowed by the [build-system] requires floor and need no edit. A [tool.uv] build-constraint-dependencies pin only affects uv.lock and the dev environment: it keeps the lock stable when new epicscorelibs releases appear. To bump it, edit that one pin, then run uv lock --upgrade-package epicscorelibs. The comment in pyproject.toml and CONTRIBUTING both say this.
• setuptools_scm replaces _version_git.py.
• ruff check replaces flake8; pyright, tox and pre-commit (incl. gitleaks) are added.
• CI uses the template's ci.yml and reusable workflows, with a custom _dist.yml that keeps the cibuildwheel wheel build and test matrix (ubuntu/windows/macos-15-intel, cp311–cp314, now a single cibuildwheel v4.3.5).
• Docs use pydata-sphinx-theme with myst and still build with -W. They use the template's docs/index.md and four section pages (Tutorials, How-to Guides, Explanations, Reference) with glob toctrees, so the top bar shows the sections and the sidebar's "Section Navigation" lists each section's pages. The existing content pages are unchanged .rst.
• CONTRIBUTING moves to the template's .github/CONTRIBUTING.md: the template's text plus our sections (clone with submodules, tests, updating dependencies and the epicscorelibs pin, DLS release steps). The docs Reference section includes it.
• CHANGELOG.rst is frozen at 4.7.2 and kept in the docs as history. Later releases use GitHub Releases with notes generated from PR titles, as in the template; the CHANGELOG release step is removed.
• Python >= 3.11 (3.7–3.10 dropped).
• All dependencies are at their latest versions; pip-audit of the exported lock (all groups and extras) and uv audit report no known vulnerabilities.

Supersedes #213: certifi 2026.10.23 is in uv.lock.

Kept minimal on purpose (deviations from the template, to avoid churn)

• README.rst kept (no README.md); docs/index.md includes its intro with the rst parser.
• Existing docs .rst content pages kept unrestructured. The section toctrees list pages explicitly where order matters (installation first, why-use-pythonSoftIOC first, API first, and the existing curated how-to order) before the glob, which picks up the rest and any future pages. The contributing page is at docs/reference/contributing.md (the template uses docs/how-to/contribute.md), and the Reference section also keeps the API page, the frozen changelog and the index.
• No ruff format: no ruff-format pre-commit hook and VS Code format-on-save / organize-imports off.
• ruff check passes with no code changes: permanent ignores N (public camelCase API) and F401/F403/F405 (star re-exports, as under flake8); temporary ignores I001/UP/SLF001/B/C4/E721 tracked in Fix ruff lint findings deferred from copier template adoption #214.
• pyright in basic mode with 10 rules off, and no filterwarnings = "error", both tracked in Tighten pyright and pytest warning config deferred from copier template adoption #215.
• Coverage still off, as decided earlier (Cothread generates segmentation faults when run with Coverage cothread#73); no codecov upload, and the template's coverage paragraph is left out of CONTRIBUTING.
• Explicit packages = ["softioc"] with package-dir = {"" = "src"} and include-package-data = false, so the wheel's file list is identical to master's (only _version_git.py becomes _version.py).
• Custom _dist.yml keeping the cibuildwheel matrix and CIBW_* settings; sdist checked with twine check; test-sdist now actually uses each matrix Python.
• submodules: true on every checkout (iocStats is needed to build).
• tests/graph.edl excluded from the end-of-file-fixer hook.
• Apart from the move to src/, the only changes in src/softioc/ and tests/ are the _version import and the template's tests/test_cli.py.
• Docs publish from master; .github/pages/index.html still redirects to master.

For maintainers to confirm

• Catalog component_owner: group:default/accelerator-controls and lifecycle production (copied from aioca/epicsdbbuilder).
• PyPI publishing now runs in a release environment (auto-created with no protection; consider adding reviewers or moving to trusted publishing). It still uses the pypi_token secret, passed explicitly; if the secret is removed the action falls back to trusted publishing.
• The weekly upstream-master test moves to Wednesday alongside the template's link check (was Monday), and now uses uv. It has not been run yet.
• The DLS release step now uses uv export --frozen --no-dev --all-extras --no-hashes --no-emit-project > …/softioc-<release>.requirements.txt instead of copying Pipfile.lock; please check this suits the internal process.
• The epicscorelibs build-constraint pin must be bumped by hand (Renovate won't), with uv lock --upgrade-package epicscorelibs; released wheels are unaffected by it.
• The dev extra is removed in favour of a dev dependency group (uv sync); cibuildwheel tests use CIBW_TEST_GROUPS: dev.
• The first release after this needs its breaking changes added to the generated GitHub release notes by hand: the dev extra is replaced by the dev dependency group, and Python 3.7–3.10 support is dropped.
• Existing dev environments need updating after pulling the src/ move: rm -rf softioc (the old untracked build products and the old iocStats checkout stay behind, and make ruff check . report errors), remove the old top-level epicscorelibs symlink if present, then git submodule update --init and uv sync --reinstall-package softioc (or use a fresh venv) so the editable install points at src/.
• The sdist now includes the full git tree (tests, docs, iocStats submodule) via setuptools_scm: about 94 KB → 384 KB for the sdist built in CI (non-recursive submodule checkout).
• The template's license.file (and license classifier) trigger a setuptools deprecation warning: builds will break after 2027-02-18 unless the template fixes it. Not changed here.

How tested

Locally on Linux:

• Wheel file list compared with a wheel built from master: identical apart from _version_git.py → _version.py; _extension*.so, device.dbd, access.acf and the iocStats iocAdmin/Db files are present.
• Installed wheel and sdist into fresh environments: pythonSoftIOC --version works and an asyncio IOC starts.
• Docs navigation checked in the built HTML: the top bar has the four sections and each section page's sidebar lists that section's pages.
• The epicscorelibs bump procedure checked by moving the pin and back: uv lock --upgrade-package epicscorelibs updates the build constraint and softioc's ABI pin in uv.lock, and restores it exactly.
• copier update --pretend reports "Keeping template version 5.5.0".
• Plus the CI on this PR.

Found in local review

• The how-to pages lost their curated order under a pure glob toctree: listed explicitly again.
• After the src/ move, a stale untracked top-level softioc/ in existing checkouts makes ruff check . fail: the clean-up steps are in the maintainer notes above.
• PR description said softioc/ instead of src/softioc/, and gave the sdist size without saying it is CI's: fixed.
• "Headling" typo in CONTRIBUTING: fixed.
• uv.lock would break on any new epicscorelibs release (dynamic metadata from the build env): build constraint added.
• The DLS release step copying Pipfile.lock had been dropped: replaced with a uv export.
• Temporary leniency was not linked to issues: now points at Fix ruff lint findings deferred from copier template adoption #214/Tighten pyright and pytest warning config deferred from copier template adoption #215.
• rtd-theme-only CSS rules did nothing under pydata: removed (the two-column CSS went with index.rst).
• VS Code format-on-save would churn whole files: turned off until Fix ruff lint findings deferred from copier template adoption #214.
• uv export for the DLS release included the dev toolchain: --no-dev added.
• The build pin was missing from the update docs: added to CONTRIBUTING.
• secrets: inherit narrowed to an explicit optional pypi_token.
• The periodic upstream-master job now has read-only permissions.

Found in maintainer review

• Docs pages were one flat list with an empty "Section Navigation": now the template's section pages.
• src/ layout, CONTRIBUTING location and CHANGELOG: now as in the template.
• The epicscorelibs bump instructions were unclear: rewritten.

Found in CI

• The new uv-based test (ubuntu-latest, 3.14) job segfaulted in cothread (in tests/test_record_values.py). The runner's system python is CPython 3.14.4; the crash reproduces locally with uv-managed 3.14.4, while 3.14.5, 3.14.6 and 3.14.7 pass the full suite. _test.yml now sets UV_PYTHON_PREFERENCE: only-managed so the latest 3.14 patch release is tested. cothread is kept on 3.14 (the cibuildwheel cp314 wheel tests with cothread pass on all three OSes); users on CPython 3.14.4 specifically may hit this crash.

Not in this PR

• Fix ruff lint findings deferred from copier template adoption #214: fix the code so the temporary ruff ignores can go (and consider ruff format).
• Tighten pyright and pytest warning config deferred from copier template adoption #215: tighten pyright and the pytest warning config.

Do not merge until the maintainers have reviewed; merge commit.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Uybqz8Ac6k38PshyLY6N1C